Overview

This branch refactors the logger stack around a configurable message pipeline and updates logger APIs to expose richer context (Logger instance, shortName) during rendering/consumption. It introduces a new configuration model in rlib-logger-impl (LoggerConfig, loaders, resolver, consumers, renderers), rewires DefaultLoggerService to use it, and expands regression coverage for level-threshold and consumer-routing behavior. Several API shape changes are intentional for alpha releases.

Changes Summary

1. Logger API evolution (rlib-logger-api)

• Added Logger.shortName() to the public Logger contract.
• Renamed logger factory entrypoints from make(...) to getLogger(...) in LoggerFactory and updated LoggerManager call sites.
• Moved service access behind LoggerFactory.getLoggerService() and updated LoggerManager to delegate level operations via that service.
• Changed LoggerService.write(...) signature from (LoggerLevel, String loggerName, String logMessage) to (Logger logger, LoggerLevel level, String message).
• Renamed null-object implementation classes to NoOps (NullLogger -> NoOpsLogger, NullLoggerFactory -> NoOpsLoggerFactory) and added NoOpsLoggerService.

2. New configurable logger pipeline (rlib-logger-impl)

• Added new config contracts:
  • LogMessageConsumer
  • LogMessageRender
  • LoggerConfig
  • LoggerConfigLoader
  • LoggerConfigResolver
• Added default implementations:
  • DefaultLoggerConfig
  • DefaultLoggerConfigLoader
  • ConsoleMessageConsumer
  • SimpleLogMessageRender
• Replaced old listener/writer-based DefaultLoggerService flow with config-driven routing:
  • Per-logger level configuration through LoggerConfig.configureLevels(...)
  • Per-level consumer resolution with fallback from logger-specific keys to root keys
  • Message rendering delegated to LogMessageRender

3. Level threshold and routing behavior fixes

• Fixed level-threshold configuration semantics so a configured level enables that level and higher severity (INFO enables INFO, WARNING, ERROR; not DEBUG/TRACE).
• Kept consumer lookup semantics as requested level and lower fallback for routing, allowing coarse consumer registration (for example TRACE consumer catches lower-priority fallbacks).
• Added reset-before-apply behavior in DefaultLoggerConfig.configureLevels(...) to avoid stale overrides.

4. DefaultLoggerService and DefaultLogger refactor

• DefaultLoggerService now stores loggers by full name and creates them through a unified factory path.
• Added robust shortName extraction for string logger names, including trailing-dot handling.
• DefaultLogger caches resolved consumers per level (trace/debug/info/warn/error) to avoid repeated config lookups during writes.
• FolderFileListener was removed as part of the old output model removal.

5. SLF4J integration updates

• Updated Slf4jLoggerFactory to the new LoggerFactory contract (getLogger(...)) and added logger instance caching.
• Added Slf4jLogger.shortName() implementation.
• Added LoggerService exposure in SLF4J factory via NoOpsLoggerService.

6. Event flow diagram

flowchart TD
  A["Logger call"] --> B["DefaultLogger checks level"]
  B --> C["DefaultLoggerService write"]
  C --> D["Resolve consumers from config"]
  D --> E["Consumer renders message"]
  E --> F["Output stream"]

7. Configuration pipeline diagrams

flowchart TD
  A["DefaultLoggerFactory created"] --> B["LoggerConfigResolver load"]
  B --> C["Collect LoggerConfigLoader list"]
  C --> D["Sort loaders by order"]
  D --> E["Try load from each loader"]
  E --> F["First present config selected"]
  F --> G["Create DefaultLoggerService with config"]

flowchart TD
  A["Logger write request"] --> B["Resolve cached consumers for level"]
  B -->|cache miss| C["DefaultLoggerConfig resolveConsumers"]
  C --> D["Lookup logger key by level fallback"]
  D -->|not found| E["Lookup ROOT key by level fallback"]
  E -->|not found| F["Use empty consumer array"]
  D -->|found| G["Return consumer array"]
  E -->|found| G
  F --> H["Cache resolved consumers"]
  G --> H
  H --> I["Consume and render message"]

8. Usage samples

// Logger retrieval using updated factory/manager shape
Logger logger = LoggerManager.getLogger(MyType.class);
Logger named = LoggerManager.getLogger("com.example.MyLogger");

// Accessing logger service for runtime level control
LoggerService service = LoggerManager.getLoggerService();
service.configureDefault(LoggerLevel.INFO, true);
service.enable(MyType.class, LoggerLevel.DEBUG);

// Logger identity helpers
String fullName = logger.name();
String shortName = logger.shortName();